home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-Sensation: Golden Games / Amiga CD-Sensation - Ausgabe 2 - Golden Games (1996)(GTI - Schatztruhe)(DE)[!].iso / Various / Diplomacy / diplomacy.doc < prev    next >
Text File  |  1992-01-04  |  22KB  |  467 lines
  1.  
  2.               /*****************************************\
  3.                *>                                     <*
  4.                *>        Diplomacy for the Amiga      <*
  5.                *>              Version 2.0            <*
  6.                *> Copyright (c) 1991 by Steve Douthat <*
  7.                *>                                     <*
  8.               \*****************************************/
  9.  
  10.                This document must accompany the program.
  11.                 The following files should be included:
  12.                         Diplomacy.doc (this file)
  13.                         Diplomacy.doc.info
  14.                         Diplomacy
  15.                         Diplomacy.info
  16.                         Data.info
  17.                         Data(dir)
  18.                            default.map
  19.                            default.provdata
  20.                            default.game
  21.                            lace1.map
  22.                            lace1.provdata
  23.                            lace2.map
  24.                            lace2.provdata
  25.  
  26.  
  27. This program is an original implementation of the classic board game, 
  28. DIPLOMACY, for the Amiga.  It is being distributed as shareware and may 
  29. be copied and distributed freely as long as the files listed above are 
  30. kept together as a set.  If you keep and use this program, please send a 
  31. minimum of $10 to the author:
  32.  
  33.    Steve Douthat
  34.    10661 Escobar Drive
  35.    San Diego, CA  92124
  36.  
  37. Comments, suggestions and bug reports are also appreciated.  Persons who 
  38. donate $20 or more will automatically receive the 'C' source code and 
  39. any subsequent revisions of this program.
  40.  
  41. Please note that this program requires at least version 1.2 of AmigaDOS 
  42. (Workbench) and 512K RAM.
  43.  
  44.  
  45. HOW TO START
  46.  
  47. The game can be started from CLI or from Workbench in the standard 
  48. fashion.  Type "diplomacy<return>" at the CLI prompt or double-click the 
  49. workbench icon.  The only requirement is that the program expects the 
  50. current directory to contain the "Data" directory with the three 
  51. "default" files.  The program supports multitasking assuming sufficient 
  52. memory is available.
  53.  
  54. The program will display the title screen as it reads in the data and 
  55. sets up the game.  Click the left mouse button when prompted to reveal 
  56. the diplomacy campaign map and start the game.
  57.  
  58. ------------------------------------------------------------------------
  59. THE GAME
  60. ------------------------------------------------------------------------
  61.  
  62. BACKGROUND
  63.  
  64. The game DIPLOMACY is a conquer-the-map type game which is published by 
  65. Avalon Hill.  It is designed for seven players with variations for as 
  66. few as two players.  This software is designed to enhance this game by 
  67. keeping track of the various parameters, resolving the orders and 
  68. controlling the flow.  This documentation describes the use of this 
  69. software only.  Please refer to the rule book included in Avalon Hill's 
  70. game for the complete set of game instructions.
  71.  
  72. The game of diplomacy is played in years consisting of three seasons: 
  73. Spring, Fall and Winter.  The Spring and Fall turns are when the players 
  74. issue orders for movement of their existing units (armies and fleets).  
  75. In the Winter turn, supply center ownership is adjusted and units are 
  76. built or disbanded accordingly.  The game starts in Spring of the year 
  77. 1901.
  78.  
  79. ISSUING ORDERS (Spring and Fall turns)
  80.  
  81. There are three possible orders for each unit on the board: hold, move 
  82. or support.  In addition, fleets have a fourth option, "convoy" of an 
  83. army from one coast to another.  In general, orders are issued by 
  84. selecting the provinces involved.  This is done by moving the mouse 
  85. pointer to the name of the province and clicking the left mouse button.  
  86. Each order requires 3 provinces: 
  87.    the province containing the unit being ordered, 
  88.    the province containing the unit that is moving, 
  89.    and the destination province.
  90. Clicking on these three provinces is usually enough to fully describe 
  91. the order.  
  92.  
  93.    HOLD: click three times on the province containing the unit.
  94.          (remember to click on the NAME of the province)
  95.  
  96.    MOVE: click twice on the province containing the unit to move;
  97.          click the province where the unit is going.  If the destination 
  98.          province is multi-coast and the unit moving is a fleet, a 
  99.          requester may appear asking which coast.
  100.  
  101. SUPPORT: click the province containing the unit providing the support;
  102.          click the province containing the unit receiving the support;
  103.          click the province where the supported unit is going/staying.
  104.          if the supporting unit is a fleet in the water and the 
  105.          supported unit is an army on the coast, then a requester may 
  106.          ask you to select between "support" or "convoy"; select 
  107.          "support".
  108.  
  109.  CONVOY: same as SUPPORT but select "convoy" at requester.  Note that a 
  110.          convoy order is not valid unless the army being convoyed is 
  111.          also ordered to move to the same province.
  112.  
  113. A text representation of the order will be constructed at the top of the 
  114. screen as each order is input.  The entire list of orders can be viewed 
  115. on-screen or printed out at any time during order entry by selecting the 
  116. proper item on the STATUS menu (see menu commands below).  Any order 
  117. which is incorrect can be changed by simply entering the correct order.  
  118. Note that virtually all orders, even those which are obviously invalid, 
  119. are accepted by the computer during order entry.  It is important to 
  120. verify that the orders have been entered as intended prior to ending the 
  121. order input phase.  Orders which are invalid will be flagged as such in 
  122. the results of the order resolution and the order will be treated as a 
  123. HOLD order.  
  124.  
  125. When all orders have been entered correctly, a click on the end gadget 
  126. in the lower right corner will signal the computer to resolve the 
  127. orders.  
  128.  
  129. ISSUING RETREAT ORDERS (Spring and Fall turns)
  130.  
  131. Some units may be dislodged as a result of order resolution.  If this is 
  132. true, the computer will wait for retreat orders to be issued.  These are 
  133. entered similar to regular orders but are simpler:  The default order is 
  134. to disband a dislodged unit.  To command a unit to retreat, click the 
  135. province from which the unit is being dislodged and then click the 
  136. destination province.  To change the order back to a disband order, 
  137. click twice on the unit's province.  The list of retreat orders can be 
  138. displayed similar to regular orders using the menu.  Click the end 
  139. gadget when all orders have been entered correctly.
  140.  
  141. ADJUSTING UNITS (Winter turn)
  142.  
  143. At the end of the Fall turn, the computer will automatically adjust 
  144. supply ownership.  Then the numbers of supplies owned will be compared 
  145. to the number of units deployed for each power.  If appropriate, the 
  146. computer will wait for build/disband orders to be issued.  These are 
  147. issued by simply clicking on the appropriate province and, if building 
  148. on a coastal province, selecting the type of unit to be built.  A power 
  149. will not be allowed to issue more builds/disbands than the supply count 
  150. calls for.  The list of adjustment orders can be displayed similar to 
  151. regular orders using the menu.  An order can be cancelled by clicking on 
  152. the province again.  Click the end gadget when all orders have been 
  153. entered correctly.
  154.  
  155. If insufficient units are selected for disbanding, additional units will 
  156. be disbanded based on location as though the power were in civil 
  157. disorder.
  158.  
  159. ------------------------------------------------------------------------
  160. THE FILES
  161. ------------------------------------------------------------------------
  162.  
  163. MAP FILES
  164.  
  165. "Default.map" is an IFF picture of the map background which is loaded 
  166. when the program is started.  It is HIRES (640x200 pixel) resolution and 
  167. has 8 colors.  It was drawn by Ken Edwards, a user/artist in Texas.  
  168. "Lace1.map" is the same map converted to INTERLACE (640x400 pixel)
  169. resolution.  "Lace2.map" is slightly larger.
  170.  
  171. You can use a paint program (e.g. Deluxe Paint) to modify these maps or 
  172. to create your own.  The names of the provinces are part of the provdata 
  173. file and should not be drawn on the picture.  The resolution you select, 
  174. the size of the map, and the number of colors greatly affects the memory 
  175. required to run Diplomacy.  The colors you choose will be all that's 
  176. available for the color of each power.  Also, the first four colors in 
  177. your palette will be used as follows:
  178.    COLOR 0 - province names and background for the text display areas
  179.    COLOR 1 - text in display areas
  180.    COLOR 6 - assumes land is this color
  181.    COLOR 7 - assumes water is this color
  182.  
  183. You can change the map that the program starts with by simply replacing 
  184. the "default.map".
  185.  
  186. PROVDATA FILES
  187.  
  188. "Default.provdata" contains the locations and types (land or water) for 
  189. all the provinces.  This data corresponds to the default (HIRES) map.  
  190. "Lace.provdata" is for use with "lace.map".
  191.  
  192. You can modify province data using the ADJUST menu or "Prov Edit Mode" 
  193. under the PREFS menu.  When you open a map the provdata is cleared and 
  194. provdata corresponding to the new map must be opened or created.
  195.  
  196. GAME FILES
  197.  
  198. "Default.game" holds the starting configuration (Spring 1901) for a 
  199. standard Diplomacy game with seven human players.  Since the names of 
  200. the provinces in the "lace.provdata" file is the same as the default, 
  201. this game file will work with either map resolution.
  202.  
  203. Game information changes as the game is played.  It can also be modified 
  204. using the ADJUST menu.
  205.  
  206. ------------------------------------------------------------------------
  207. THE MENU
  208. ------------------------------------------------------------------------
  209.  
  210. PROJECT MENU
  211.    These commands affect the entire game and can be used anytime.
  212.  
  213.          To Back - sends game screen behind workbench, etc to allow 
  214.                    multitasking control
  215.  
  216.      Default Map - opens the "Data/default.map" IFF picture adjusting 
  217.                    the screen resolution and colors to match.  This 
  218.                    operation erases all province data and game 
  219.                    information.
  220.  
  221.         Open Map - same as DEFAULT MAP but provides a requester so you 
  222.                    can select which picture file to open.  Any IFF 
  223.                    picture can be used as a background but keep in mind 
  224.                    that the screen will take on the characteristics of 
  225.                    the picture used and memory requirements could vary 
  226.                    greatly.  
  227.  
  228. Default ProvData - opens the "Data/default.provdata" file.  This file 
  229.                    must correspond to the map currently being used for 
  230.                    the province gadgets to line up properly with the 
  231.                    background.
  232.  
  233.    Open ProvData - same as DEFAULT PROVDATA but provides a requester so 
  234.                    you can select which provdata file to open.
  235.  
  236.    Save ProvData - overwrites last saved provdata file with current 
  237.                    province data.  This option is identical to "SAVE 
  238.                    PROVDATA AS" if the data has not been previously 
  239.                    saved.
  240.  
  241. Save ProvData As - saves current province data in file on disk for later 
  242.                    retrieval using OPEN command.
  243.  
  244.         New Game - restarts game at Spring 1901 (or whatever 
  245.                    configuration is specified in "Data/default.game" 
  246.                    file).
  247.  
  248.        Open Game - loads previously saved game (requires entry of name 
  249.                    of game file).
  250.  
  251.        Save Game - overwrites last saved game file with current 
  252.                    configuration.  This option is identical to "SAVE 
  253.                    GAME AS" if the game has been previously saved.
  254.  
  255.     Save Game As - saves current game configuration in file on disk for 
  256.                    later retrieval using OPEN command.
  257.  
  258.             Quit - closes game screen and returns to workbench/CLI.
  259.  
  260.            About - shows revision number and credits.
  261.  
  262. STATUS MENU
  263.    These commands provide data output to the desired device.
  264.  
  265.   Display Orders - shows list on screen of all units by power and their 
  266.                    current order.  This option is useful to allow order 
  267.                    entry to be double-checked prior to clicking "end" 
  268.                    for results.
  269.  
  270. Display Supplies - shows list of powers and the supply centers each 
  271.                    currently owns on screen.
  272.  
  273.     Print Orders - outputs list of orders to printer.
  274.  
  275.     Print Status - outputs current status info to printer; includes list 
  276.                    of units for each power; this is handy to produce a
  277.                    worksheet for writing orders during the diplomacy 
  278.                    period.
  279.  
  280.      Save Orders - stores list of orders as text file on disk.
  281.  
  282.      Save Status - stores current status info as text file on disk.
  283.  
  284. PREFS MENU
  285.    This menu allows selection of various display and output modes.  A 
  286.    check is displayed in the menu next to each option selected.  Any 
  287.    combination is acceptable including no output (no check marks).  
  288.  
  289.  Display Results - shows list on screen of units, their orders and the 
  290.                    end result after each turn.  This option is selected 
  291.                    by default.
  292.  
  293.    Print Results - outputs to printer.  This is useful in providing a 
  294.                    hard copy of results for reference during game play.  
  295.  
  296.     Save Results - outputs to a history file on disk.  This will 
  297.                    preserve a history of the game useful for analysis 
  298.                    and other future reference.
  299.  
  300.      Make Sounds - makes a beep sound whenever an error message is 
  301.                    displayed.  This is the only sound this game can 
  302.                    produce.
  303.  
  304.   Auto Save Game - automatically saves game to a new disk file after 
  305.                    each turn is completed.  Files are named using the 
  306.                    root name specified in the requester and adding an 
  307.                    extension indicating the date of the game turn.  This 
  308.                    option is highly recommended in that it protects you 
  309.                    against computer resets and lets you revert back to a 
  310.                    previous turn at will.
  311.  
  312.     Show Borders - displays lines between the province name gadgets 
  313.                    which show which provinces are bordering each other.  
  314.                    The lines are color-coded to indicate which type of 
  315.                    unit can traverse the border.  Black and brown lines 
  316.                    are for armies only, black and aqua are for fleets, 
  317.                    and brown and aqua means both armies and fleets can 
  318.                    traverse.  (Note: colors depend on the palette of the 
  319.                    map being used.  This option would typically be used 
  320.                    only if creating or modifying the province data.  
  321.  
  322.   Prov Edit Mode - suspends game play and allows easy access to the map-
  323.                    editing features.  Click in open space to add a 
  324.                    province.  Click a province gadget to pick it up to 
  325.                    move (delete it by clicking the end gadget while 
  326.                    holding it).
  327.  
  328. ADJUST MENU
  329.    These commands give the user raw power to adjust the game to any 
  330.    configuration.  Although the game has been play-tested and is 
  331.    believed tofollow the rules accurately in resolving orders, 
  332.    gamemasters can choose to over-ride the decisions and adjust the map 
  333.    to what they believe is correct.  This menu also includes the map 
  334.    editing commands which can be used to modify the province data.
  335.  
  336.           Season - change season.
  337.  
  338.             Year - change year.
  339.  
  340.          Players - brings up a requester which allows player data to be 
  341.                    modified.  This includes names of players, the 
  342.                    power(s) each player controls and whether the player 
  343.                    is to be controlled by the computer (AI) or not.  If 
  344.                    computer control is selected, the computer will issue 
  345.                    all orders for the powers controlled by that player.  
  346.                    Any number of players can be computer-controlled and 
  347.                    each player will act independently.  To place a power 
  348.                    in civil disorder, simply leave it under human (i.e., 
  349.                    not computer) control and don't issue any orders for 
  350.                    it.  The default civil disorder rules will be 
  351.                    followed in resolving orders.
  352.  
  353.           Powers - brings up a requester which allows power data to be 
  354.                    modified.  This includes names of powers and color 
  355.                    used to represent each power on the map.
  356.  
  357.             Unit - build/change/disband a unit.  Any unit in the 
  358.                    province selected is replaced by the unit built.
  359.  
  360.   Current Supply - change/eliminate current ownership of a supply 
  361.                    province.
  362.  
  363.      Home Supply - change/eliminate home ownership of a home supply 
  364.                    province.
  365.  
  366.     Add Province - creates a new province name gadget on the map with 
  367.                    the name you provide.  You are then prompted to 
  368.                    establish borders with existing provinces.  Use the 
  369.                    "end" gadget to indicatewhen all the borders have 
  370.                    been selected.  If the province being added has more 
  371.                    than one coast, use "Adjust Borders" to add the 
  372.                    additional border information.
  373.  
  374.    Move Province - click on province gadget to pick it up and click 
  375.                    again to drop in new location.  Drop the province 
  376.                    gadget on the "end" gadget to delete it.
  377.  
  378.  Rename Province - select province and type new name in requester 
  379.                    gadget.
  380.  
  381. Change Prov Type - change water to land and vice versa.  Also to modify 
  382.                    supply centers.
  383.  
  384.   Adjust Borders - select province to modify, then select the bordering 
  385.                    provinces for armies and for each of the four 
  386.                    possible coasts.  Use Show Borders mode (Prefs Menu) 
  387.                    so you can see what you're doing.
  388.  
  389. ------------------------------------------------------------------------
  390. KNOWN BUGS/LIMITATIONS
  391. ------------------------------------------------------------------------
  392.  
  393. The computer opponent is extremely limited in ability and this option 
  394. has not been thoroughly debugged.  Teaching a computer to actually play 
  395. this game is more challenging than originally anticipated.  
  396.  
  397. Otherwise, there are no known bugs.  Please let me know if you have any 
  398. problems.
  399.  
  400. ------------------------------------------------------------------------
  401. NEW TO REVISION 1.1
  402. ------------------------------------------------------------------------
  403.  
  404. The program now sports a more elaborate file requester for saving and 
  405. retrieving files.  This is the "FileIO Requester" designed by RJ Mical 
  406. and included in his Amiga Programmer's Suite Book 1.01.  It lists files 
  407. in current directory and allows movement through directories.  Thanks 
  408. RJ!
  409.  
  410. ------------------------------------------------------------------------
  411. NEW TO REVISION 1.2
  412. ------------------------------------------------------------------------
  413.  
  414. Now you can save results and game status to a disk file. Output is 
  415. controlled with its own menu and you can now have the game maintain a 
  416. history file on disk for future reference.
  417.  
  418. Also, the map has been greatly enhanced by Ken Edwards, a user/artist in 
  419. Texas. Thanks Ken!
  420.  
  421. ------------------------------------------------------------------------
  422. NEW TO REVISION 2.0
  423. ------------------------------------------------------------------------
  424.  
  425. New features have been added to the menu to greatly assist those who 
  426. wish to modify the game board or create new worlds to conquer.  The menu 
  427. has been reorganized to accommodate these additions.
  428.  
  429. The map now expands to fit the entire screen area available.  This won't 
  430. mean anything to most users, but those who have squeezed extra pixels 
  431. out of their monitors will be able to take advantage of them.
  432.  
  433. Interlace versions of the default map and provdata are provided.  These 
  434. can be loaded from the project menu (load the map first) or they can 
  435. replace the defaults by changing their names.
  436.  
  437. Orders for retreats, builds and disbands are now handled similar to 
  438. regular orders in that printing, saving and map viewing are all 
  439. permitted while issuing these orders.
  440.  
  441. Fixed bug which caused Guru if diplomacy was quit while top edge of map 
  442. is displayed.
  443.  
  444. Fixed bug in adjudicating orders which previously allowed supported move 
  445. into province occupied by friendly unit which does not successfully move 
  446. out.
  447.  
  448. A warning has been added to the quit sequence to provide one last chance 
  449. to save files before the program quits.
  450.  
  451. A computer opponent will play any country or countries independently or 
  452. as a team (see "known bugs/limitations").  This allows for a one-player 
  453. game of World War I or variant thereof.
  454.  
  455. ------------------------------------------------------------------------
  456. PLANNED REVISIONS
  457. ------------------------------------------------------------------------
  458.  
  459. Port to Macintosh.
  460.  
  461. Fix/improve computer opponent.
  462.  
  463. ------------------------------------------------------------------------
  464.    Diplomacy is Copyright (c) 1976 Avalon Hill Game Company
  465.    Diplomacy for Amiga is Copyright (c) 1988, 1989, 1991 Steve Douthat
  466.    Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  467. ------------------------------------------------------------------------